home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d2 / rir.arc / RIR.DOC < prev    next >
Encoding:
Text File  |  1990-10-20  |  5.1 KB  |  140 lines
  1. RIR - Rock dIRectory
  2.  
  3. Purpose
  4.  
  5.     Rock Directory (RIR) is substitute command for DOS's
  6.     directory (DIR) with a few additions.  The syntax and output
  7.     of RIR is virtually identical to that of DOS's "DIR" command,
  8.     making it easy to learn.
  9.  
  10.  
  11. Uses
  12.  
  13.     RIR also allows the /W and /P parameters just as DOS's DIR
  14.     command works.  RIR is primarily of use to those who have a
  15.     large number of compressed files.  Its automatic detection of
  16.     compressed files makes it easier to use than most methods of
  17.     viewing the contents of compressed files; it displays them
  18.     along with a directory's other files.
  19.  
  20.     The features RIR provides that DIR does not are:
  21.  
  22.         A single key can be used to pause/restart the display,
  23.         and ESC can be used to halt the display, as with several
  24.         of the other rock utilities.
  25.  
  26.         RIR displays the contents of compressed files, such as
  27.         ".ARC" and ".ZIP" files.
  28.  
  29.         RIR can optionally display hidden files, with the /h
  30.         option.
  31.  
  32.         RIR can display directory listings with two files per
  33.         line if desired.
  34.  
  35.     The compressed file formats that RIR understands are:
  36.  
  37.         .ARC, .DWC, .LBR, .LZH, .LZS, .MD, .PKA, .PAK, .ZIP, .ZOO
  38.  
  39.     Note that RIR does not decode self-extracting compressed
  40.     files, which end in .COM or .EXE.
  41.  
  42. What are compressed files?
  43.  
  44.     Not everyone uses, or needs to use, compressed files.  This
  45.     section is for those who are confused by what the term
  46.     "compressed file" means.
  47.  
  48.     A compressed file is a single file created to store one or
  49.     more other files in a "compressed" format to save space.  A
  50.     special compression/decompression program is required to do
  51.     this, such as "ARC" and "PKZIP," both available from most
  52.     shareware distribution sources or bulletin board systems.
  53.  
  54.     Compression is used for several reasons; to save space with
  55.     old files that are rarely used, to fit a lot of data on
  56.     floppy disks, or to send file through telephone lines more
  57.     quickly.  You might squeeze five 100K text files into a
  58.     single 200K compressed file, store it on a floppy, and when
  59.     you need it again, decompress it into the original five
  60.     files.  Those who download files with modems most often
  61.     receive the files in a compressed form.
  62.  
  63.     It's often convenient to view the contents of comrpessed
  64.     files without actually decompressing them.  Most
  65.     decompression programs can show the contents of files
  66.     compressed in their own format, but each compression program
  67.     has its own file format.  RIR shows you the contents of many
  68.     formats of compressed files.
  69.  
  70.  
  71. Syntax
  72.  
  73.     RIR [d:][path][filespec] [options]
  74.  
  75.     Options
  76.        /P      Pause every screenful (just like with DIR)
  77.        /W      Display in Wide format (5 files per line)
  78.        /2      Display two files per line instead of one
  79.        /T      Text lines only, e.g. <-- instead of ──
  80.        /H      Show "hidden" files also
  81.  
  82.     Examples
  83.        rir             Show current dir, with compressed files
  84.        rir /p          Show current dir, pausing every screen
  85.        rir c:\new\*.*  Show files in the directory c:\new
  86.  
  87.     Control Keys
  88.        ESC     Stop the program immediately
  89.        Others  Pause the program until next key pressed
  90.  
  91. Example - show current directory
  92.  
  93.     The arrows following the extensions in the following examples
  94.     indicate that the file is contained within the compressed
  95.     file preceding it.  In the example below, the file
  96.     "OLD_PROG.LZH" contains the files "PROG.PAS", "PROG.TPU", and
  97.     "READ.ME".  Note that the default directory listing is easier
  98.     to read than the listings with two or five-files per line.
  99.  
  100.     C:\DATA>rir
  101.  
  102.     RIR-Rock dIRectory 1.11, (Type RIR ? for help) (C) 1990 Rock
  103.  
  104.      Volume in drive C is Test2
  105.      Directory of  C:*.*
  106.  
  107.     .           <DIR>     04-11-90   9:37a
  108.     ..          <DIR>     04-11-90   9:37a
  109.     LOG         <DIR>     03-22-90   3:39a
  110.     OLD_PROG LZH╕   3192 04-11-90   9:45a
  111.     PROG     PAS─┤   3289 03-21-90  11:45a
  112.     PROG     TPU─┤   2016 03-21-90  11:54a
  113.     READ     ME ─┘    742 03-21-90  11:54a
  114.     AUGUST   LOG          03-22-90   3:02a
  115.     QMOVE    ARC╕  11657 04-11-90   9:48a
  116.     QMOVE    EXE─┤  10464 02-11-89  10:30a
  117.     QMOVE    PAS─┘  10063 02-11-89  10:29a
  118.     ZD110    ZOO╕  20210 04-11-90   9:43a
  119.     readme   1st─┤   1979 10-26-86   5:48p
  120.     zoo      doc─┤  39357 08-24-86   1:03p
  121.     zoobench txt─┘   4008 09-06-86  10:46p
  122.             9 File(s)    9601024 bytes free
  123.  
  124.  
  125. Example - show directory in wide format (normally 5 files/line)
  126.  
  127.     C:\DATA>rir \files\compress /w
  128.  
  129.     RIR-Rock dIRectory 1.11, (Type RIR ? for help) (C) 1990 Rock
  130.  
  131.      Volume in drive C is Test2
  132.      Directory of  C:\FILES\COMPRESS\*.*
  133.  
  134.     .              ..             LOG            OLD_PROG LZH═══
  135.     PROG     PAS──PROG    TPU───READ    ME     AUGUST   LOG
  136.     QMOVE    ARC══QMOVE   EXE───QMOVE   PAS───ZD110    ZOO═══
  137.     readme   1st──zoo     doc───zoobench txt
  138.             9 File(s)    9601024 bytes free
  139.  
  140.